Overview & Concepts


Table of Contents


1. Introduction

1.1 What This System Is

1.2 What This System Is Not

1.3 Intended Use Cases

2. System Overview

2.1 High-Level Architecture

2.2 Component Roles

3. Core Data Structures

3.1 The Lexicon

3.2 Chunks

3.3 Word.Iteration Schema

3.4 Mnemonic as Transformation Assembly

3.5 Indices as State Selectors

3.6 Randomness Source

3.7 Determinism vs Variability

4. Active Key Construction

4.1 Mnemonic Parsing Rules

4.2 Chunk Selection Logic

4.3 Resulting Active Key

5. Transformation Model

5.1 Pass-Based Processing

5.2 Index Mechanics

5.3 Directional Agnosticism

6. Determinism & Behavior

6.1 Deterministic Inputs → Deterministic Outputs

6.2 Effects of Changing:

6.3 Modulo Normalization

6.4 Behavioral Implications

7. Failure Modes & Verification

7.1 Silent Failure Modes

7.2 False Confidence Risks

7.3 Verification Strategies

7.4 Irreversibility Conditions (optional but strong)

8 Comparison to One-Time Pad Systems

8.1 Similarities

8.2 Key Differences

8.3 Interpretation Guidelines

9. Design Evolution (Vizini → Current)

9.1 Key Differences from V1

9.2 Rationale for Changes

10. Terminology

10.1 Canonical Definitions

10.2 Notes on Non-Standard Terminology




1. Introduction

1.1 What This System Is

Vizini v2 is a deterministic, lexicon-driven data transformation system that derives its behavior from a combination of structured data and user-provided inputs.

Rather than using a single static key, Vizini v2 generates a transformation space based on:

Given the same inputs, the system will always produce the same output, making it reversible when all required inputs are reproduced exactly.

The system is designed to explore alternative approaches to data transformation, key derivation, and entropy utilization. It emphasizes flexibility and composability over strict adherence to established cryptographic standards.

1.2 What This System Is Not

Vizini v2 is not a formally validated cryptographic system and should not be treated as a substitute for established encryption standards.

Specifically:

While the system may exhibit encryption-like behavior, its security properties are not formally defined.

1.3 Intended Use Cases

Vizini v2 is best suited for controlled, experimental, or exploratory applications where its behavior can be fully understood and externally validated.

Appropriate use cases include:

It may also be useful in scenarios where:

Vizini v2 is not recommended for:

2. System Overview

2.1 High-Level Architecture

Vizini v2 is composed of three loosely coupled components that operate on shared data structures rather than direct inter-process communication.

At a high level, the system follows a produce → analyze → apply workflow:

All components interact through portable, file-based artifacts:

There is no requirement for background services, persistent daemons, or network connectivity. Each component can operate independently, provided it has access to the required inputs. There is no shared runtime state between components beyond these artifacts.

This architecture emphasizes:

2.2 Component Roles

Scribe (Lexicon Creation & Modification)

Scribe is responsible for generating and modifying Lexicons (VLex databases), which serve as the foundational data structure for all transformations.

Its primary responsibilities include:

The quality and structure of the Lexicon directly influence the behavior of the transformation process.

LAT / Audit (Lexicon Inspection & Analysis)

LAT (Lexicon Analysis Tool) provides visibility into the structure and characteristics of a Lexicon.

It is used to:

LAT does not modify the Lexicon-it is strictly an analysis and auditing tool.

This component is especially important for understanding how a given Lexicon may behave when used in transformation.

Vizini2 the Cipher Engine (Data Transformation)

The Vizini2 Engine performs the actual data transformation process.

Using:

…the engine derives a deterministic transformation structure and applies it to input data.

Key characteristics:

The Engine is where all components converge, turning structured inputs into transformed output data.

3. Core Data Structures

3.1 The Lexicon

The Lexicon (VLex) is the central data structure in Vizini v2. It defines the transformation space used by the system.

Lexicons are stored as SQLite databases, providing portability, reliability, and a well-understood storage format.

A typical Lexicon contains:

The Lexicon is both a dataset and is a structured mapping system that directly influences how input data is transformed.

3.2 Chunks

Chunks are the fundamental building blocks within a Lexicon.

Definition

A Chunk represents a grouped unit of transformation data, consisting of one or more substitution mappings (S-boxes).

Structure

Each Chunk contains:

Chunks are designed to be composable and iterable, allowing complex transformation behavior to emerge from relatively simple components.

Weight

Weight refers to the number of S-boxes contained within a Chunk.

Weight influences transformation complexity and diffusion, but does not increase the entropy of the underlying source data.

3.3 Word.Iteration Schema

Chunks are identified using a structured naming convention:

word.iteration

Examples:

Naming Convention

Depth

Depth refers to how many unique iterations exist for a given word within the Lexicon.

Depth defines the boundary at which repeated use of a word in a mnemonic may begin to reuse underlying transformation structures.

Iteration Behavior

Iteration behavior describes how repeated occurrences of a word in a mnemonic are resolved.

Depending on the Lexicon:

This schema allows a single mnemonic element to expand into a structured sequence of transformation steps.

3.4 Mnemonic as Transformation Assembly

The mnemonic phrase acts as the primary driver for selecting and ordering Chunks during transformation.

Rather than functioning as a traditional cryptographic key, the mnemonic:

Each mnemonic element found in the Lexicon maps to one Chunk via the word.iteration schema, contributing its weight (S-box count) to the Active Key.

Mnemonic elements not present in the Lexicon are ignored.

The mnemonic therefore acts as a deterministic assembly layer, shaping how the Lexicon is applied.

3.5 Indices as State Selectors

Indices define the starting state within the assembled transformation sequence (Active Key).

They are used to:

While the mnemonic defines what is used, indices define where execution begins.

Small changes in indices can result in entirely different transformation paths through the Active Key.

3.6 Randomness Source

Scribe uses the operating system's cryptographically secure pseudorandom number generator (CSPRNG) to generate S-box permutations.

Each S-box is shuffled four times to promote high-quality distribution.

While it is theoretically possible to construct a Lexicon using true random sources, the use of a CSPRNG is considered sufficient for practical purposes, as it provides:

The system’s behavior is therefore not limited by randomness quality, but by how that randomness is structured and applied.

3.7 Determinism vs Variability

Vizini v2 operates at the intersection of determinism and variability.

Determinism

Given identical inputs:

…the system will always produce the same output.

This ensures reproducibility and reversibility under correct conditions.

Variability

Changing any component-even slightly-can produce drastically different outputs:

This creates a system where:

This duality is central to how Vizini v2 functions.

4. Active Key Construction

4.1 Mnemonic Parsing Rules

The mnemonic is first normalized and tokenized before any Chunk selection occurs. This ensures consistent behavior regardless of formatting differences.

Lowercasing

All mnemonic input is normalized to lowercase prior to processing.

This avoids case-sensitivity issues and ensures that:

This normalization improves usability without affecting deterministic behavior.

Delimiters

Mnemonic input is tokenized using non-alphanumeric characters as delimiters.

This includes:

As a result, the following are split into multiple tokens:

This behavior may be non-intuitive in some cases, but it ensures consistent and implementation-simple tokenization.

Ignored Tokens

Tokens that do not exist in the Lexicon are silently ignored.

This allows users to include:

For example, a mnemonic may include words purely to improve memorability or linguistic flow, even if they do not contribute to the transformation.

Ignored tokens do not affect the resulting Active Key.

4.2 Chunk Selection Logic

Once tokenized, each valid token is mapped to a Chunk using the word.iteration schema.

First Occurrence vs Repeated Words

Each occurrence of a word in the mnemonic is processed independently.

Example:

alpha alpha alpha

May resolve to:

This allows repeated words to expand into distinct transformation components.

Iteration Exhaustion Behavior

When the number of occurrences of a word exceeds its available depth, iteration selection wraps using modulo behavior.

Example (depth = 2):

alpha alpha alpha alpha

Resolves to:

This introduces reuse of underlying transformation structures.

As repetition increases beyond depth, the transformation begins to reuse previously selected Chunks, which may reduce effective variation.

4.3 Resulting Active Key

After processing all valid tokens, the system constructs a linear sequence of S-boxes derived from the selected Chunks.

This sequence is referred to as the Active Key (colloquially), and represents the full transformation structure applied to the data.

Ordering Guarantees

The Active Key preserves the exact order of mnemonic-derived Chunk selection.

This means (assuming the same Lexicon is used):

Example:

alpha beta alpha beta

Will always produce the same ordered sequence of Chunks and S-boxes.

There is no internal randomization at this stage - ordering is strictly deterministic.

Total Weight

The total weight of the Active Key is the sum of the weights of all selected Chunks.

This determines:

The total number of S-boxes in the transformation sequence The overall length and complexity of the transformation path

Higher total weight results in:

Lower total weight results in:

The Active Key is fully determined before transformation begins and remains static for the duration of the operation.

5. Transformation Model

5.1 Pass-Based Processing

Vizini v2 processes data using a two-pass transformation model, where each pass operates over the same Active Key but may differ in direction and initialization.

Forward Pass

The forward pass:

This is typically associated with “encryption,” though the system itself does not enforce semantic labeling.

Reverse Pass

The reverse pass:

Despite being referred to as “Pass 2,” this pass is still logically the second (backward) stage of transformation-even when the overall process is inverted.

Pass Inversion Behavior

During reverse operations (e.g., decryption):

However, the labels “Pass 1” and “Pass 2” remain tied to their directional correlation, not execution order.

This ensures consistent configuration regardless of operation direction.

5.2 Index Mechanics

Indices define the evolving state of traversal through the Active Key during transformation.

Initial Index Inputs

Each pass begins with its own user-defined initial index:

These indices determine the initial position within the Active Key’s S-box sequence.

Index Shifting Behavior (Ciphertext-Driven)

After each byte is processed, the active index is updated based on the value of the resulting ciphertext byte.

Specifically:

new_index = (current_index + ciphertext_byte) mod total_weight

This creates a data-dependent traversal path, where each output byte influences the position of the next transformation step.

Implications of Index Shifting

5.3 Directional Agnosticism

Vizini v2 does not fundamentally distinguish between encryption and decryption as separate algorithms.

Instead, both operations are symmetric transformations with inverted parameters.

Encrypt vs Decrypt Equivalence

When all inputs are correctly reproduced, the transformation is fully reversible.

Performance Characteristics

Decryption may be marginally slower than encryption due to use of inverse S-box lookups instead of direct indexed access

This difference is typically minimal but can become noticeable with large datasets or high-weight Active Keys.

6. Determinism & Behavior

6.1 Deterministic Inputs → Deterministic Outputs

Vizini v2 is fully deterministic.

Given identical inputs:

…the system will always produce identical output.

There is no internal randomness during transformation. All variability is introduced exclusively through input differences.

This determinism ensures:

6.2 Effects of Changing Inputs

Small changes to any input component can produce large and unpredictable differences in output.

Mnemonic Changes

Changing the mnemonic:

Even minor changes (e.g., a single word) can produce entirely different transformation behavior.

Lexicon Changes

Changing the Lexicon:

Even if the mnemonic and indices remain the same, a different Lexicon will produce completely different results.

Starting Index Changes

Changing starting indices:

Because index shifting is ciphertext-driven, even small index changes propagate through the entire transformation.

6.3 Modulo Normalization

Vizini v2 uses modulo normalization to ensure all index operations remain within valid bounds.

Index Wrapping

When an index exceeds the bounds of the Active Key (total weight), it is wrapped using modulo arithmetic:

index = index mod total_weight

This guarantees:

Overflow Handling

Index growth is unbounded in theory but constrained in practice through normalization.

Because index updates are based on ciphertext byte values:

This ensures consistent behavior regardless of input size or content.

6.4 Behavioral Implications

The combination of determinism and input sensitivity produces several important characteristics:

Because any valid input produces an output:

(See Section 7.3 for recommended validation strategies.)

7. Failure Modes & Verification

7.1 Silent Failure Modes

Vizini v2 does not provide internal validation of correctness.

Any variation in input-including changes to the Lexicon, mnemonic, or starting indices-will produce a valid transformation output, regardless of correctness.

There are no errors, warnings, or indicators of misuse.

Because the transformation engine operates strictly on a “data in → data out” model, it is also possible to apply additional transformation layers without restriction. This flexibility increases composability, but does not provide any inherent validation.

7.2 False Confidence Risks

The absence of internal validation introduces the risk of false confidence.

As a result, users may incorrectly assume that a transformation was successful when it was not.

This risk is especially significant when working with human-readable data, where incorrect outputs may still appear plausible.

7.3 Verification Strategies

To ensure correctness, external verification mechanisms must be used.

Common strategies include:

These approaches allow users to distinguish between correct and incorrect outputs despite the system’s lack of internal validation.

7.4 Irreversibility Conditions

Certain failure conditions result in practical irreversibility.

Loss of Lexicon

Recovery probability is effectively zero.

Loss of Mnemonic

While tools such as LAT may assist in analysis, the search space remains extremely large and recovery is unlikely in practice.

Parameter Mismatch

The total number of possible index combinations is bounded by the square of the Active Key weight:

total_combinations ≈ (total_weight)²

Even moderate weights result in impractically large search spaces for brute-force recovery.

8. Comparison to One-Time Pad Systems

8.1 Similarities

This system shares some conceptual similarities with one-time pad (OTP) encryption:

8.2 Key Differences

However, it differs in several important ways:

8.3 Interpretation Guidelines

As a result, this system should not be considered equivalent to a one-time pad.

9. Design Evolution (Vizini → Current)

Vizini v1 was developed as a proof-of-concept to validate the core transformation model: an indexed collection of S-boxes, with selection driven by feedback from the transformation process.

Vizini v2 builds on this foundation by introducing dynamic key construction, improved randomness, and a more structured data model. These changes shift the system from a fixed experimental design to a flexible and user-driven transformation framework.

9.1 Key Differences from V1

9.2 Rationale for Changes

Dynamic Index Construction

Improved Randomness Source

Double-Pass Transformation

Mnemonic as Core Key Material

Structured Storage (SQLite)

Metadata Integration

Platform & Toolchain Shift

Vizini v2 shifts the system from a fixed transformation mechanism to a user-defined transformation space.

10. Terminology

10.1 Canonical Definitions

General Cryptographic Terms

Technical Implementation Terms

10.2 Notes on Non-Standard Terminology

Project-Specific Terms